FDS EXPLORER v1.63
==================
* Use this program at your own risk! *



What is it?
-----------
It's a utility for browsing/manipulating files on an FDS image. An FDS image is a dump of
a Famicom System Disk that are often used by emulators.



Requirements?
-------------
FDS Explorer requires the .NET framework 3.5 and some FDS images. :)



How to use?
-----------
I think the GUI is pretty simple. Open the FDS-image and simply change disk/side
by using the radiobuttons. To view the contents of a file, click on it and
it will appear to the left in an hex/ascii-dump.

When opening an FDS image, all filenames will be displayed together with their
filenumber, fileID, Load address, size and type.



Delete a file
-------------
Right click on the file to delete and pick "delete file" from the context menu.
Notice that no changes are saved until you use the "Save FDS" option.



Add file
--------
Files can now be added to the FDS disk image assuming there is enough space.
Click the "Add file" tab on the currently selected disk/side and pick the file
to import. 
There are a few fields that needs to be entered aswell:
FDS-filename	= Name of the file on disk
Load address	= Enter the load address here (for example: "$6000")
Type			= Type of file (PRG/CHR/Nametable)
FileID			= Enter the FileID here. A value equal or less than the
				  the current disks BootID will cause the BIOS to load
				  the file during boot.


Export disk/side as FDS
-----------------------
Some FDS images are "overdumped". Some one-disk(or even one-sided games)
are dumped as 2 disk games. 
Browse to the disk you want to save, right-click in the filebrowser and choose
"Export - Current Disk as FDS" if you want to export the current disk or
"Current Side as FDS" to only export the current diskside.



Save FDS
--------
To save your changed FDS you have to use the "Save FDS" option. :)
It can be found in the "File" menu. Select it and enter your new filename.
A wise choice is NOT to overwrite your original FDS file unless you're
REALLY sure on what you're doing.

When the FDS is saved, all possible garbage data is removed. Which means
the FDS may compress better using Winzip/WinRAR than the original file.

Save as NES
-----------
FDS Explorer can now convert FDS disks to .NES fileformat. However it's
quite restricted. FDSExplorer examines the current disk-side and check it if
may properly convert to a .NES file. The conditions are that the disc 
must have a 32K PRG-file and a 8K CHR-file. If so, the file is exported
with a NES header. 
Notice that FDS Explorer only exports the data to a .NES file. You manually
have to change the mapper-number and perhaps "hack" the ROM to make it
run on NES-emulators.
Ideas on how to enhance this feature in the future is very welcome.


Disassemble
------------
FDS Explorer can now disassemble files in an FDS-image. The disassembler
is a work-in-progress so beware of possible bugs. :)
A disassembled file can also be exported (right click on the file, pick
export - > asm)
Check "Trace 1-pass" to enable a more advanced (and experimental) algorithm
to disassemble the code and to make it more readable.



Limitations
-----------
Disks that use a non-standard filesystem is obviously not supported.
Disks that contain hidden files are not yet properly supported.



Bugs
-------------
* The "add file" function doesn't yet correctly calculates the free space on
disk. However you shouldn't be bothered about this unless you're running REALLY 
low on diskspace.
* Some disks obviously contain hidden files which are not yet detected by
FDS Explorer. Such disks may not function properly when using the "Save as FDS"
option as all files are not copied.
* Disassembler is not bugfree. 


Contact the author
------------------
He loves to get nice e-mails. :)

Mailto: morjoh (a) live.se



What's new?
-----------
v1.63	2014-01-01	* More disassembler bugfixes
					* Some graphics-related bugfixes.

v1.62	2013-04-17	* Minor disassembler bugfixes
					* Minor bugfixes.

v1.61	2011-01-06  * Added "trace-mode" to the disassembler. Experimental.
					* Minor bugfixes.


v1.6	2010-01-25	* Now properly loads FDS-images with no
					  fwNES FDS-header. Exported files are always
					  saved with this kind of header.
					* Some disassembler-bugfixes.
					* Disassembler improved (now displays register-comments)
					* Requires .NET framework 3.5
					  
v1.5b	2008-04-05	* CHR-tab implemented, allows you to view FDS-files
					 as graphics (and save as PNG)
					* Export filelist is now possible in contextmenu
					* Option to disassemble to uppercase.
					* Minor bugfixes
					* Now requires .NET framework 2.0

v1.3b	2006-06-17	* Minor bugfixes
					* Misc minor changes

v1.2b	2006-05-11	* FDS images can be splitted
					* Disassembly-function (W.I.P)
					* Save as .NES (W.I.P)
					* Minor bugfixes

v1.1b	2006-04-23	MAJOR UPDATE!
					* Files can now be added to disk.
					* "Delete file" added.
					* Save as new FDS

v1.0	2006-04-21	* First non-beta release. :)
